Skip to main content
PATCH
광고 단위 수정

인증

Authorization
string
header
필수

Bearer 인증. 액세스 토큰을 Authorization: Bearer <token> 헤더로 전달합니다.

경로 매개변수

ad_unit_id
string<uuid>
필수

본문

application/json

PATCH /ad-units/{id} 요청 본문.

  • code는 변경 불가 — 허용되지 않음.
  • is_active는 /activate, /deactivate로 관리 — 허용되지 않음.
  • partial_safe_update_only=True인 경우 안전한 필드만 적용됩니다: name, description, ext.target_ecpm, ext.default_cpa, ext.default_cpc, ext.bcat.
ad_unit_sizes
AdUnitSize · object[] | null

타게팅용 크기 메타데이터.

description
string | null

광고 단위 설명.

display
DisplayPlacement · object | null

디스플레이 게재 위치 설정.

ext
AdUnitExt · object | null

광고 단위 확장 필드.

gpid
string | null

OpenRTB imp.ext.gpid에 사용되는 표준 게재 위치 ID.

instl
enum<integer> | null

전면 광고 여부. 0 = 아니오, 1 = 예.

사용 가능한 옵션:
0,
1
name
string | null

광고 단위 표시 이름 (1-255자).

Required string length: 1 - 255
native
NativePlacement · object | null

네이티브 게재 위치 설정.

partial_safe_update_only
boolean | null
기본값:false

true이면 광고 단위가 게재 중일 때 안전하게 수정 가능한 필드만 적용합니다:

  1. 이름
  2. 설명
  3. 목표 eCPM
  4. 기본 CPA
  5. 기본 CPC
  6. 추천 설정
  7. 차단 광고주 카테고리
recommendation
RecommendationPlacement · object | null

추천 설정.

siteid
string | null

이 광고 단위에 연결된 사이트 식별자.

video
VideoPlacement · object | null

비디오 게재 위치 설정.

응답

성공 응답

광고 단위 변경(생성/수정) 응답 스키마.

code
string
필수

광고 단위 코드 식별자.

created_by
string<uuid>
필수

광고 단위를 생성한 사용자 ID.

id
string<uuid>
필수

광고 단위 ID (uuid7)

name
string
필수

광고 단위 이름.

path
string
필수

광고 단위의 계층 경로 (예: "parent_id/child_id").

ad_unit_sizes
AdUnitSize · object[] | null

타게팅 메타데이터 크기. 서빙·렌더링을 좌우하는 display/video.w/h와는 별개입니다.

created_at
string<date-time> | null
description
string | null

광고 단위 설명.

display
DisplayPlacement · object

디스플레이 게재 위치 설정.

ext
AdUnitExt · object

광고 단위 확장 필드.

gpid
string | null

OpenRTB imp.ext.gpid에 사용되는 표준 지면 ID.

instl
enum<integer>
기본값:0

인터스티셜 지면 여부. 0 = 아니오, 1 = 예. 디스플레이·동영상·네이티브 전체에 적용됩니다.

사용 가능한 옵션:
0,
1
is_active
boolean | null

광고 단위 활성 여부.

native
NativePlacement · object

네이티브 지면임을 나타내는 지면 서브타입 객체입니다. (AdCOM 표준이 아닌 OpenRTB Native Ads 1.2 Native Markup Request Object 기반)

no
integer | null
recommendation
RecommendationPlacement · object
updated_at
string<date-time> | null
video
VideoPlacement · object

비디오 게재 위치 설정.